Version: 1.3.0

Agent API Documentation

Models Retrieval Endpoint

Method: GET
Path: https://api.kadal.ai/aiwb/bot/api/v2/models
Summary: Pull the model details with all required parameters needed to define a Bot.

Description

This endpoint retrieves comprehensive model information required for bot configuration, including provider-specific details and model parameters to balance quality and performance.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
provider Provider of the model String openai, palm No
model_name Name of the model String gpt-4o, gpt-4o-mini No

Parameter	Description	Data Type	Allowed Values	Required
provider	Provider of the model	String	openai, palm	No
model_name	Name of the model	String	gpt-4o, gpt-4o-mini	No

Response

{
  "status_code": 200,
  "message": "Success: Model details retrieved successfully.",
  "data": {
    "models": [
      {
        "provider": "openai",
        "model_name": "gpt-4o",
        "parameters": {}
      }
    ]
  }
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v2/models"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

params = {
    "provider": "openai",
    "model_name": "gpt-4o"
}

# Make the GET request
response = requests.get(url, headers=headers, params=params)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Creation Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3
Summary: Create and configure customized chatbots with comprehensive options.

Description

This endpoint enables users to create and configure customized chatbots with comprehensive options. Users can specify model details (OpenAI/Palm), context, temperature, token limits, and other generation parameters. The API supports four bot types ('Custom', 'Super Agent', 'Orchestrator', 'External') with knowledge from content folders/objects, guidelines, and examples.

Request

Content-Type: application/json

Payload

Parameter	Description	Data Type	Allowed Values	Required
chatbotName	Name of the chatbot	String		Yes
modelId	Model identifier	String	gpt-4o, gpt-4o-mini	Yes
modelVersion	Model version	String	latest	Yes
context	Bot context/instructions	String		No
temperature	Model temperature	Number	0.0-1.0	No
maxTokens	Maximum token limit	Integer		No
botType	Type of bot	String	Custom, Super Agent, Orchestrator, External	No

Response

{
  "status_code": 200,
  "message": "Success: Chat Bot created successfully.",
  "chatbot_global_id": "uuid-here",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "chatbotName": "My Custom Bot",
    "modelId": "gpt-4o",
    "modelVersion": "latest",
    "context": "You are a helpful assistant.",
    "temperature": 0.7,
    "maxTokens": 2000,
    "botType": "Custom"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bots Listing Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/List/
Summary: Retrieve a list of available chat bots with filtering and pagination.

Description

This endpoint provides functionality to retrieve a list of available chat bots. The API supports filtering, pagination, and sorting of chat bots. The API also supports grouping of bots by created_by field.

Request

Content-Type: application/json

Payload

Parameter	Description	Data Type	Allowed Values	Required
page_no	Page number to retrieve	Integer		No
page_size	Number of items per page	Integer		No
order	Sort order by creation time	String	asc, desc	No
is_published	Filter by published status	Boolean	true, false	No
group_by	Field to group by	String	created_by	No

Response

{
  "status_code": 200,
  "message": "Success: Chat bots retrieved successfully.",
  "total_bot_count": 10,
  "chat_bots": []
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/List/"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "page_no": 1,
    "page_size": 10,
    "order": "asc",
    "is_published": True,
    "group_by": "created_by"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Retrieval Endpoint

Method: GET
Path: https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}
Summary: Retrieve a specific chatbot by its ID.

Description

This endpoint allows users to retrieve details of a specific chatbot using its unique identifier.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)

Response

{
  "status_code": 200,
  "message": "Success: Chat bot retrieved successfully.",
  "data": {
    "chatbot_id": "uuid-here",
    "chatbotName": "Bot Name",
    "modelId": "gpt-4o"
  }
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the GET request
response = requests.get(url.format(chatbot_id=chatbot_id), headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Update Endpoint

Method: PUT
Path: https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}
Summary: Update an existing chatbot configuration.

Description

This endpoint allows users to update the configuration of an existing chatbot by providing the chatbot ID and updated parameters.

Request

Content-Type: application/json

Payload

Parameter	Description	Data Type	Allowed Values	Required
chatbot_id	Unique chatbot identifier	String		Yes (Path)
chatbotName	Updated name of the chatbot	String		No
modelId	Updated model identifier	String	gpt-4o, gpt-4o-mini	No
context	Updated bot context/instructions	String		No
temperature	Updated model temperature	Number	0.0-1.0	No

Response

{
  "status_code": 200,
  "message": "Success: Chat bot updated successfully.",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "chatbotName": "Updated Bot Name",
    "context": "Updated context for the bot",
    "temperature": 0.8
}

# Make the PUT request
response = requests.put(url.format(chatbot_id=chatbot_id), headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Deletion Endpoint

Method: DELETE
Path: https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}
Summary: Delete a specific chatbot by its ID.

Description

This endpoint allows users to permanently delete a chatbot using its unique identifier.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)

Response

{
  "status_code": 200,
  "message": "Success: Chat bot deleted successfully.",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the DELETE request
response = requests.delete(url.format(chatbot_id=chatbot_id), headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Publish Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/publish/{chatbot_id}
Summary: Publish a chatbot to make it available for public use.

Description

This endpoint allows users to publish a chatbot, making it available for public access and deployment.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)

Response

{
  "status_code": 200,
  "message": "Success: Chat bot published successfully.",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/publish/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the POST request
response = requests.post(url.format(chatbot_id=chatbot_id), headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bot Unpublish Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/unpublish/{chatbot_id}
Summary: Unpublish a chatbot to remove it from public access.

Description

This endpoint allows users to unpublish a chatbot, removing it from public access while keeping it available for editing.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)

Response

{
  "status_code": 200,
  "message": "Success: Chat bot unpublished successfully.",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/unpublish/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the POST request
response = requests.post(url.format(chatbot_id=chatbot_id), headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Get Embed Credentials Endpoint

Method: GET
Path: https://api.kadal.ai/aiwb/bot/api/v3/embed/get_credentials/{chatbot_id}
Summary: Retrieve embed credentials for a chatbot.

Description

This endpoint allows users to retrieve embed credentials for integrating a chatbot into external websites or applications.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)

Response

{
  "status_code": 200,
  "message": "Success: Embed credentials retrieved successfully.",
  "data": {
    "embed_token": "embed-token-here",
    "embed_url": "https://embed.kadal.ai"
  }
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/embed/get_credentials/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the GET request
response = requests.get(url.format(chatbot_id=chatbot_id), headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Generate Embed Credentials Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/embed/generate_credentials/{chatbot_id}
Summary: Generate new embed credentials for a chatbot.

Description

This endpoint allows users to generate new embed credentials for a chatbot, including target configuration for deployment.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)
target_id Target deployment identifier String Yes

Response

{
  "status_code": 200,
  "message": "Success: Embed credentials generated successfully.",
  "data": {
    "embed_token": "new-embed-token-here",
    "embed_url": "https://embed.kadal.ai"
  }
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/embed/generate_credentials/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "target_id": "your_target_id"
}

# Make the POST request
response = requests.post(url.format(chatbot_id=chatbot_id), headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Set Active/Inactive Status Endpoint

Method: PATCH
Path: https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}
Summary: Set a chatbot to active or inactive status.

Description

This endpoint allows users to set the active or inactive status of a chatbot. Only superadmin can set the active status of any agent belonging to any tenant. Tenant admin can set the active status of agents belonging to their tenant.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
chatbot_id Unique chatbot identifier String Yes (Path)
is_active Active status flag Boolean true, false Yes

Response

{
  "status_code": 200,
  "message": "Success: Chatbot status updated successfully.",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/{chatbot_id}"
token = "your_token_here"
chatbot_id = "your_chatbot_id"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "is_active": True
}

# Make the PATCH request
response = requests.patch(url.format(chatbot_id=chatbot_id), headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Agent Maker Bot Creation Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/agent_maker
Summary: Create an agent maker bot with specialized capabilities.

Description

This endpoint allows users to create an agent maker bot with selected modelID and modelVersion. When not specified, GPT-4o is set as the default model.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
modelId Model identifier String gpt-4o, gpt-4o-mini No
modelVersion Model version String latest No
chatbotName Name of the agent maker bot String Yes

Parameter	Description	Data Type	Allowed Values	Required
modelId	Model identifier	String	gpt-4o, gpt-4o-mini	No
modelVersion	Model version	String	latest	No
chatbotName	Name of the agent maker bot	String		Yes

Response

{
  "status_code": 200,
  "message": "Success: Agent maker bot created successfully.",
  "chatbot_global_id": "uuid-here",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/agent_maker"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "chatbotName": "My Agent Maker Bot",
    "modelId": "gpt-4o",
    "modelVersion": "latest"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Orchestrator Bot Creation Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/orchestrator
Summary: Create an orchestrator bot for managing multiple agents.

Description

This endpoint allows users to create an orchestrator bot with selected modelID and modelVersion. When not specified, GPT-4o is set as the default model. Orchestrator bots can coordinate multiple agents and manage complex workflows.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
modelId Model identifier String gpt-4o, gpt-4o-mini No
modelVersion Model version String latest No
chatbotName Name of the orchestrator bot String Yes

Parameter	Description	Data Type	Allowed Values	Required
modelId	Model identifier	String	gpt-4o, gpt-4o-mini	No
modelVersion	Model version	String	latest	No
chatbotName	Name of the orchestrator bot	String		Yes

Response

{
  "status_code": 200,
  "message": "Success: Orchestrator bot created successfully.",
  "chatbot_global_id": "uuid-here",
  "data": {}
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/orchestrator"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "chatbotName": "My Orchestrator Bot",
    "modelId": "gpt-4o",
    "modelVersion": "latest"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Target Creation Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/targets
Summary: Create deployment targets for chatbots.

Description

This endpoint allows users to create deployment targets for their chatbots with specified domain configurations.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
target_name Name of the target String Yes
domain_name Domain name for deployment String Yes

Parameter	Description	Data Type	Allowed Values	Required
target_name	Name of the target	String		Yes
domain_name	Domain name for deployment	String		Yes

Response

{
  "status_code": 200,
  "message": "Success: Target created successfully.",
  "target_id": "target-id-here"
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/targets"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "target_name": "Production Target",
    "domain_name": "example.com"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Targets Listing Endpoint

Method: GET
Path: https://api.kadal.ai/aiwb/bot/api/v3/targets
Summary: Retrieve list of deployment targets.

Description

This endpoint retrieves a list of all deployment targets available for the authenticated user's tenant.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required

Response

{
  "status_code": 200,
  "message": "Success: Targets retrieved successfully.",
  "targets": []
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/targets"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the GET request
response = requests.get(url, headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Target Update Endpoint

Method: PUT
Path: https://api.kadal.ai/aiwb/bot/api/v3/targets/{target_id}
Summary: Update an existing target deployment configuration.

Description

This endpoint allows users to update the configuration of an existing target deployment.

Request

Headers: Authorization: Bearer <token>

Payload

Field	Description	Type	Example	Required
url	Target deployment URL	String	"https://example.com/api"	Yes
label	Target deployment label	String	"Production API"	Yes
description	Target deployment description	String	"Main production environment"	No

Response

{
  "message": "Success: Target updated successfully.",
  "target_id": "target-id-here"
}

Usage

import requests

url = "https://api.kadal.ai/aiwb/bot/api/v3/targets/target-id-here"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

payload = {
    "url": "https://updated-example.com/api",
    "label": "Updated Production API",
    "description": "Updated main production environment"
}

response = requests.put(url, headers=headers, json=payload)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Target Deletion Endpoint

Method: DELETE
Path: https://api.kadal.ai/aiwb/bot/api/v3/targets/{target_id}
Summary: Delete a target deployment configuration.

Description

This endpoint allows users to permanently delete a target deployment configuration.

Request

Headers: Authorization: Bearer <token>
Payload
None required. The target ID is specified in the URL path.

Response

{
  "message": "Success: Target deleted successfully."
}

Usage

import requests

url = "https://api.kadal.ai/aiwb/bot/api/v3/targets/target-id-here"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.delete(url, headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Category Creation Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v3/categories
Summary: Create categories for organizing chatbots.

Description

This endpoint enables users to create categories for organizing chatbots with customizable labels and descriptions.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required
label Category label String Yes
description Category description String No

Parameter	Description	Data Type	Allowed Values	Required
label	Category label	String		Yes
description	Category description	String		No

Response

{
  "status_code": 200,
  "message": "Success: Category created successfully.",
  "category_id": "category-id-here"
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/categories"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "label": "Customer Support",
    "description": "Bots for customer support functions"
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Categories Listing Endpoint

Method: GET
Path: https://api.kadal.ai/aiwb/bot/api/v3/categories/List/
Summary: Retrieve a list of available categories.

Description

This endpoint provides functionality to retrieve a list of available categories for organizing chatbots.

Request

Content-Type: application/json
Payload
Parameter Description Data Type Allowed Values Required

Response

{
  "status_code": 200,
  "message": "Success: Categories retrieved successfully.",
  "categories": []
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v3/categories/List/"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

# Make the GET request
response = requests.get(url, headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Category Update Endpoint

Method: PUT
Path: https://api.kadal.ai/aiwb/bot/api/v3/categories
Summary: Update an existing category configuration.

Description

This endpoint allows users to update the configuration of an existing category.

Request

Headers: Authorization: Bearer <token>
Query Parameters:
- label (string, required): The current label of the category to update
Payload
Field Description Type Example Required
label New category label String "Updated Category" Yes
description New category description String "Updated description" No

Field	Description	Type	Example	Required
label	New category label	String	"Updated Category"	Yes
description	New category description	String	"Updated description"	No

Response

{
  "message": "Success: Category updated successfully.",
  "category_id": "category-id-here"
}

Usage

import requests

url = "https://api.kadal.ai/aiwb/bot/api/v3/categories?label=OldCategoryLabel"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

payload = {
    "label": "Updated Category Label",
    "description": "Updated category description"
}

response = requests.put(url, headers=headers, json=payload)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Category Deletion Endpoint

Method: DELETE
Path: https://api.kadal.ai/aiwb/bot/api/v3/categories
Summary: Delete a category configuration.

Description

This endpoint allows users to permanently delete a category configuration.

Request

Headers: Authorization: Bearer <token>
Query Parameters:
- label (string, required): The label of the category to delete
Payload
None required. The category label is specified as a query parameter.

Response

{
  "message": "Success: Category deleted successfully."
}

Usage

import requests

url = "https://api.kadal.ai/aiwb/bot/api/v3/categories?label=CategoryToDelete"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.delete(url, headers=headers)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Chat Bots Category-wise Listing Endpoint

Method: POST
Path: https://api.kadal.ai/aiwb/bot/api/v4/CategoryWise/List/
Summary: Retrieve a list of available chat bots organized by categories.

Description

This endpoint provides functionality to retrieve a list of available chat bots organized by categories. The API searches using created_by, tenant_id, is_published, metadata fields, and uses MongoDB find method for querying.

Request

Content-Type: application/json

Payload

Parameter	Description	Data Type	Allowed Values	Required
tenant_id	Tenant identifier	String		Yes
page_no	Page number	Integer		No
page_size	Number of items per page	Integer		No
order	Sort order	String	asc, desc	No
is_published	Filter by published status	Boolean	true, false	No

Response

{
  "status_code": 200,
  "message": "Success: Chat bots retrieved successfully.",
  "total_bot_count": 10,
  "chat_bots": [],
  "total_category_count": 5,
  "categories": []
}

Usage

import requests

# Define the API endpoint and the payload
url = "https://api.kadal.ai/aiwb/bot/api/v4/CategoryWise/List/"
token = "your_token_here"

headers = {
    "Authorization": f"Bearer {token}"
}

data = {
    "tenant_id": "your_tenant_id",
    "page_no": 1,
    "page_size": 10,
    "order": "asc",
    "is_published": True
}

# Make the POST request
response = requests.post(url, headers=headers, json=data)

# Print the response
if response.status_code == 200:
    print("Response Data:", response.json())
else:
    print("Failed to call the API. Status Code:", response.status_code)
    print("Response Text:", response.text)

Agent API Documentation

Models Retrieval Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Creation Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bots Listing Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Retrieval Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Update Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Deletion Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Publish Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Chat Bot Unpublish Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Get Embed Credentials Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Generate Embed Credentials Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Set Active/Inactive Status Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Agent Maker Bot Creation Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Orchestrator Bot Creation Endpoint​

Description​

Request​

Payload​

Response​

Usage​

Target Creation Endpoint​

Models Retrieval Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Creation Endpoint

Description

Request

Payload

Response

Usage

Chat Bots Listing Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Retrieval Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Update Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Deletion Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Publish Endpoint

Description

Request

Payload

Response

Usage

Chat Bot Unpublish Endpoint

Description

Request

Payload

Response

Usage

Get Embed Credentials Endpoint

Description

Request

Payload

Response

Usage

Generate Embed Credentials Endpoint

Description

Request

Payload

Response

Usage

Set Active/Inactive Status Endpoint

Description

Request

Payload

Response

Usage

Agent Maker Bot Creation Endpoint

Description

Request

Payload

Response

Usage

Orchestrator Bot Creation Endpoint

Description

Request

Payload

Response

Usage

Target Creation Endpoint

Description